home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / cropgif.exe / CROPGIF.DOC next >
Text File  |  1990-04-15  |  11KB  |  261 lines
  1. GIF FILE CROPPER 1.1
  2. __________________________________________________________________
  3.  
  4. If you like this program, please do one of the following:
  5.  
  6. Go down to your local bookstore and buy a copy of "Coven: A 
  7. Novel", by Steven William Rimmer, published by Ballantine Books. 
  8. In Canada, try Coles... they usually have it. Read the book and 
  9. tell your friends about it if you like it. Send us some comments 
  10. about the book or a photocopy of the cover and we'll consider you 
  11. a registered user of this program.
  12.  
  13. Alternately, send us $25.00, the normal user fee for this 
  14. software. (The book is $3.95 or $5.50 in Canada: considerably 
  15. cheaper than cash.) 
  16.  
  17. Registered users of this software are entitled to phone support, 
  18. notification of upgrades and good karma. Our address can be found 
  19. at the end of this file.
  20. __________________________________________________________________
  21.  
  22.  
  23. Thanks for checking out CROPGIF.
  24.  
  25. This program will allow you to crop fragments from existing GIF 
  26. files. The fragments will be written to new... smaller... GIF 
  27. files. 
  28.  
  29. Unlike other GIF cropping programs, this one doesn't involve the 
  30. use of any tricky measurements. It works like the cut and paste 
  31. functions of a paint program. It requires that a Microsoft 
  32. compatible mouse driver be present before it will work, as the 
  33. mouse does all the work.
  34.  
  35. In order to make the program work reasonably fast and in a 
  36. decent amount of memory, the image you'll get to work with 
  37. will not be a full colour one. Instead, CROPGIF will show you a 
  38. dithered monochrome version of your source GIF file. However, the 
  39. destination file will have the same colours as the source file 
  40. did.
  41.  
  42. Because the CROPGIF display works with monochrome graphics, it 
  43. can be used with pretty well any display card. It supports:
  44.  
  45.     - CGA (ugh!)
  46.     - EGA
  47.     - VGA
  48.     - Hercules monochrome
  49.  
  50. and, of course, anything which can emulate these modes. It should 
  51. automatically sense your display card type.
  52.  
  53. Here's how the beast works. Let's assume that you have a GIF file 
  54. called ANGELA.GIF, from which you wish to crop a fragment to be 
  55. called FACE.GIF. We'll allow that the fragment will probably 
  56. contain Angela's face, although the program itself probably won't 
  57. care.
  58.  
  59. Note that FACE.GIF, the destination file, will be created by 
  60. CROPGIF. ANGELA.GIF, the source file, will not be modified in any 
  61. way.
  62.  
  63. Making sure that you have previously loaded your mouse driver... 
  64. and that, prior to doing so you have indeed remembered to buy a 
  65. mouse... you would type the following:
  66.  
  67. CROPGIF ANGELA.GIF FACE.GIF
  68.  
  69. In fact, you can leave off the .GIF extensions, as CROPGIF 
  70. assumes these. You will see a beg notice... please don't merely 
  71. ignore this... with the program status below it. CROPGIF will 
  72. begin by loading ANGELA.GIF. It will then proceed to dither 
  73. ANGELA.GIF, that is, to create a temporary black and white 
  74. version of it. When this is complete, your screen will pop into 
  75. graphics mode and you'll see the dithered image.
  76.  
  77. The dithered image probably won't look too great, but don't worry 
  78. about this. It's only used to help you decide what to crop out, 
  79. and has no effect on the final image.
  80.  
  81. Move the mouse cursor to the upper left corner of the part of the 
  82. image you want to crop out. Hold down the left mouse button and 
  83. drag your mouse until the bounding rectangle encloses everything 
  84. you want to crop into FACE.GIF. Release the mouse button.
  85.  
  86. If you discover that you've selected the wrong bit of the picture 
  87. you can click your mouse to erase the bounding rectangle and try 
  88. again.
  89.  
  90. When you've got the right part of the picture enclosed, hit the 
  91. End key and your screen will return to text mode. The beg notice 
  92. will return... once again, please don't ignore this... and you'll 
  93. see a line at the bottom of your screen informing you that your 
  94. fragment is being written to FACE.GIF.
  95.  
  96. When this is done, you'll return to the DOS prompt.
  97.  
  98. If you change your mind and decide you don't want to crop a 
  99. fragment once you're in graphics mode, just hit Esc to return to 
  100. DOS.
  101.  
  102. Note that if you attempt to crop a fragment in which either 
  103. dimension is less than eight pixels, CROPGIF will assume you've 
  104. made a mistake and abort.
  105.  
  106. Also note that the cropped fragment will include everything 
  107. within the bounding rectangle and the pixels under the lines of 
  108. the rectangle.
  109.  
  110.  
  111. OTHER DETAILS
  112. _____________
  113.  
  114. CROPGIF uses a fair bit of memory, especially for large GIF 
  115. files. It might refuse to function on machines with restricted 
  116. memory, or on computers which have a lot of resident stuff 
  117. already loaded.
  118.  
  119. Some of the more voluminous GIF files around might be larger than 
  120. your screen. This probably won't occur if you use a VGA card... 
  121. which will show you up to 640 by 480 pixels in monochrome mode... 
  122. but it could happen on an EGA or Herc system. In this case, you 
  123. can make the picture scroll around by simply moving the mouse 
  124. cursor to the edge of your screen.
  125.  
  126. If your computer refuses to go into graphics mode, chances are 
  127. you have a multimode card which is confusing CROPGIF. In this 
  128. case, you can manually force the screen mode by adding a third 
  129. command line argument. For example, this would make CROPGIF use 
  130. Hercules graphics.
  131.  
  132. CROPGIF ANGELA.GIF FACE.GIF /HER
  133.  
  134. The following are the mode switches which CROPGIF recognizes.
  135.  
  136. /CGA    -     CGA card
  137. /EGA    -    EGA card
  138. /VGA    -    VGA card in 640 by 480 monochrome mode
  139. /HER    -    Hercules card in 720 by 438 monochrome mode
  140.  
  141. Some low rent Microsoft compatible mice seem to have a problem in 
  142. some graphics modes, in that their cursors will refuse to move 
  143. more than about halfway down the screen, flash on and off, vanish 
  144. and so on. The Agiler mouse, for example, is a problem. This 
  145. doesnt happen with real Microsoft mice, or with the better 
  146. compatibles, such as the LogiTech mice.
  147.  
  148. Some versions of the ATI EGA Wonder card refuse to go into the
  149. Hercules graphics mode under CROPGIF. The EGA graphics mode works 
  150. fine. We're looking into this.
  151.  
  152.  
  153. ROLL YOUR OWN
  154. _____________
  155.  
  156. This is another book plug. If you're interested in writing 
  157. programs which use graphics, you'll find everything you need to 
  158. know in "The Book of Bitmapped Graphics", also by Steven William 
  159. Rimmer. It's published by TAB books, (TAB book 3558) and should 
  160. be available in August 1990. It features code to pack and unpack 
  161. MacPaint, IMG, PCX, GIF and TIFF files, as well as chapters on 
  162. screen drivers, dithering and printing.
  163.  
  164.  
  165. MORAL DOGMA
  166. ___________
  167.  
  168. If you like this program and find it useful, you are requested to 
  169. support it either by buying the book mentioned at the top of this 
  170. file or by sending us $25.00. We'd rather you bought the book. 
  171. This will entitle you to telephone support, notification of 
  172. updates and other good things like that. More to the point, 
  173. though, it'll make you feel good. We've not infested the program 
  174. with excessive beg notices, crippled it or had it verbally insult 
  175. you after ten days. We trust you to support this program if 
  176. you like it.
  177.     Oh yes, should you fail to support this program and 
  178. continue to use it, a leather winged demon of the night will tear 
  179. itself, shrieking blood and fury, from the endless caverns of the 
  180. nether world, hurl itself into the darkness with a thirst for 
  181. blood on its slavering fangs and search the very threads of time 
  182. for the throbbing of your heartbeat. Just thought you'd want to 
  183. know that.
  184.  
  185. We are
  186.                       Alchemy Mindworks Inc.
  187.                           P.O. Box 500
  188.                          Beeton, Ontario
  189.                              L0G 1A0
  190.                              Canada
  191.  
  192. Other programs we've done that you might like include:
  193.  
  194. Scoop    -  MacPaint, GEM/IMG and PC Paintbrush file readers, 
  195.             with Epson FX-80, LaserJet and PostScript printer 
  196.             support. Drives CGA, EGA, VGA and Hercules cards. 
  197.             Source code in Turbo C and Microsoft MASM is 
  198.             included for this program.
  199. HP_Slash -  Make LaserJet soft fonts smaller by selectively excising
  200.             those characters you'll never use.
  201. Calendar -  Slick perpetual calendar that tells you when the 
  202.             equinoxes happen, what day Michaelmas fell on in 1705 
  203.             and so on.
  204. gemCAP   -  Capture graphics screen in GEM/IMG paint format, 
  205.             suitable for inhalation into Ventura.
  206. CPM2DOS  -  Read CP/M formatted disks on your PC.
  207. IMGCUT   -  Crop GEM/IMG paint files into smaller files.
  208. ADDRESS  -  Memory resident envelope addresser with graphics.
  209. VFM      -  Ventura soft font manager deluxe with a side of fries. 
  210.             Adds new fonts and creates width tables with menu 
  211.             driven simplicity.
  212. MCOPY    -  Copying program which packs as many files as possible
  213.             onto a floppy, pauses when the current floppy is
  214.             full and asks for another one.
  215. TCAP     -  A text screen capture program which generates GEM/IMG
  216.             graphics that look like your text, all ready for inhalation
  217.             into Ventura.
  218. GRAFCAT  -  Prints a visual catalog of your image files, with 
  219.             sixteen pictures to a page. Drives all LaserJet and 
  220.             PostScript laser printers, and works with any mixture 
  221.             of GIF, PCX, MAC and IMG files.
  222. GRAPHIC
  223.  WORKSHOP - This is the last word in image programs. It converts, 
  224.             prints, views, dithers and halftones MacPaint, 
  225.             GEM/Ventura IMG, PCX, GIF, TIFF and EPS files. It 
  226.             drives CGA, Hercules, EGA, VGA, Paradise and ATI VGA 
  227.             Wonder cards. It features batch processing, extended 
  228.             and expanded memory support, an intuitive user 
  229.             interface and easy to follow menus. It allows you to 
  230.             convert colour image files into superb black and 
  231.             white clip art for desktop publishing, among other 
  232.             things. 
  233.  
  234. If you can't find them in the public domain, they're available 
  235. from us for $25.00 each, except Graphic Workshop, which is 
  236. $35.00.
  237.  
  238.  
  239. REVISION HISTORY
  240. ________________
  241.  
  242.  
  243. Version 1.1 - Now supports monochrome GIF files.
  244.  
  245.  
  246. LEGAL DOGMA
  247. ___________
  248.  
  249. The author assumes no responsibility for any damage or loss 
  250. caused by the use of these programs, however it comes down. If 
  251. you can think of a way a picture program can cause you damage 
  252. or loss you've a sneakier mind than mine.
  253.  
  254. All the trademarks used herein are registered to whoever it is 
  255. that owns them. This notification is given in lieu of any 
  256. specific list of trademarks and their owners, which would not be 
  257. as inclusive and would probably take a lot longer to type. 
  258.  
  259. That's it...
  260.  
  261.